home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / Fresco / build / Unix / config / cf / README < prev    next >
Encoding:
Text File  |  1995-07-12  |  16.4 KB  |  376 lines
  1. $XConsortium: README,v 1.37 94/04/18 17:13:36 gildea Exp $
  2.  
  3. The easiest way to write an Imakefile is to find another one that does
  4. something similar and copy/modify it!
  5.  
  6. Imake.tmpl provides defaults for the following variables:
  7.  
  8.     AlternateIncRoot    compiler needs -I to find project includes
  9.     AlternateUsrLibDir    linker needs -L to find project libraries
  10.     ArCmd            command used to create libraries
  11.     ArCmdBase        program name part of ArCmd
  12.     ArAddCmd        flags to have ArCmdBase add files to a library
  13.     ArExtCmd        flags to have ArCmdBase extract files
  14.     AsCmd            command used to run assembler
  15.     BootstrapCFlags        missing cpp symbols needed to get started
  16.     BourneShell        command used to run Bourne Shell
  17.     CCsuf            suffix that C++ source files have
  18.     CURDIR            current directory relative to top of sources
  19.     CcCmd            command to run C compiler
  20.     CompressCmd        command to run compress program
  21.     ConstructMFLAGS        System V option to set MFLAGS make variable
  22.     CpCmd            command to copy one file to another
  23.     CplusplusCmd        command to run C++ compiler
  24.     CplusplusYaccCmd    command to produce C++ source from yacc source
  25.     CppCmd            command to run C preprocessor
  26.     CrossCompiling        cross compiling? (not fully supported)
  27.     DebuggableCDebugFlags    C compiler -I's and -D's to turn on debug info
  28.     DefaultCCOptions    default special C compiler options
  29.     DefaultCDebugFlags    debug/optimize flags for programs
  30.     DefaultUsrBin        program directory used even if PATH not set
  31.     DependFlags        extra makedepend flags
  32.     DoRanlibCmd        boolean for system uses ranlib
  33.     EqnCmd            command used for eqn
  34.     ExecableScripts        boolean for systems that can exec() #!/bin/sh
  35.     ExpandManNames        boolean to expand man pages names to long form
  36.     ExtraFilesToClean    extra files to remove on make clean
  37.     ExtraLibraries        system-specific libraries need to link
  38.     ExtraLoadFlags        system-specific loader flags
  39.     FileManSuffix        man suffix for file format pages
  40.     FilesToClean        files to delete in make clean
  41.     FortranCmd        command to run Fortran compiler
  42.     FortranDebugFlags    flags for Fortran debug info
  43.     FortranFlags        Fortran compiler flags
  44.     HasBSD44Sockets        boolean for system has BSD4.4 sockets
  45.     HasBsearch        boolean for libc has bsearch()
  46.     HasCenterLineC        boolean for system has CenterLine C compiler
  47.     HasCenterLineCplusplus    boolean for system has CenterLine C++ compiler
  48.     HasCodeCenter        boolean for system has CodeCenter
  49.     HasCplusplus        system has a C++ compiler?
  50.     HasDECnet        system has DECnet?
  51.     HasFortran        boolean for system has Fortran compiler
  52.     HasGcc            boolean for system has GNU gcc compiler
  53.     HasGcc2            boolean for system has GNU gcc 2.x compiler
  54.     HasGcc2ForCplusplus    use gcc 2 for C++ programs?
  55.     HasKrb5            system has Kerberos version 5 support?
  56.     HasLargeTmp        boolean for system has /tmp space
  57.     HasNdbm            boolean for system has ndbm routines
  58.     HasPoll            use poll() syscall?
  59.     HasPurify        boolean for system has Purify
  60.     HasPutenv        boolean for libc has putenv()
  61.     HasSecureRPC        boolean for Sun Secure RPC
  62.     HasSentinel        boolean for system has Sentinel available
  63.     HasSharedLibraries    boolean for system has shared libraries
  64.     HasShm            boolean for System V shared memory
  65.     HasSockets        boolean for system has BSD sockets
  66.     HasStreams        use STREAMS I/O interface?
  67.     HasSymLinks        boolean for system has symbolic links
  68.     HasTestCenter        boolean for system has TestCenter
  69.     HasVFork        boolean for system has vfork()
  70.     HasVoidSignalReturn    boolean for POSIX signal() procs
  71.     IncRoot            parent of X11 include directory
  72.     InstBinFlags        install flags for binaries
  73.     InstDatFlags        install flags for data files
  74.     InstIncFlags        install flags for header files
  75.     InstKmemFlags        install flags for xload to get at /dev/kmem
  76.     InstLibFlags        install flags for libraries
  77.     InstManFlags        install flags for manual pages
  78.     InstPgmFlags        install flags for normal programs
  79.     InstUidFlags        install flags for xterm to chown /dev/ptys
  80.     InstallCmd        command to install files
  81.     IxxCmd            IDL to C++ command
  82.     Krb5Includes        where to include Kerberos header files from
  83.     Krb5Libraries        where to load Kerberos libraries from
  84.     LdCmd            command to run loader
  85.     LdCombineFlags        flags for incremental loading
  86.     LexCmd            command to run lex
  87.     LexLib            library for programs using lex output
  88.     LintCmd            command to run lint
  89.     LintLibFlag        flags to generate lint libraries
  90.     LintOpts        lint options to control strictness
  91.     LnCmd            command to link two files
  92.     LoaderLibPrefix        loader flags before libraries
  93.     MacroFile        name of machine-dependent config params file
  94.     MacroIncludeFile    <MacroFile>
  95.     MakeCmd            command to run make
  96.     Malloc0ReturnsNull    boolean for malloc(0) == NULL
  97.     MathLibrary        library for programs using C math functions
  98.     MsMacros        macro flag for TroffCmd, normally "-ms"
  99.     MvCmd            command to rename a file
  100.     NdbmDefines        -D's to turn on use of ndbm routines
  101.     NeedConstPrototoypes    whether const is supported
  102.     NeedFunctionPrototypes    whether or not to force function prototypes
  103.     NeedNestedPrototypes    whether nested prototypes are supported
  104.     NeedVarargsPrototypes    whether varargs prototypes are supported
  105.     NeedWidePrototypes    whether or not to widen function prototypes
  106.     NoOpCDebugFlags        C compiler flags to not debug or optimize
  107.     NoRConst        YES if const for structs of funcs is bad
  108.     OSMajorVersion        major version number of operating system
  109.     OSMinorVersion        minor version number of operating system
  110.     OptimizedCDebugFlags    C compiler flags to turn on optimization
  111.     PreProcessCmd        command to run /lib/cpp on scripts
  112.     RanlibCmd        command to clean up libraries
  113.     RanlibInstFlags        flags to ranlib after copying
  114.     RmCmd            command to delete files
  115.     ShLibDir        directory in which to install shared libraries
  116.     StandardCppDefines    -D's for running cpp
  117.     StandardDefines        -D's for running C compiler
  118.     StandardIncludes    -I's for running C compiler
  119.     StripInstalledPrograms    boolean for sites that want to install -s
  120.     SystemV            boolean for systems that are at least SVR2
  121.     SystemV4        boolean for SVR4 systems
  122.     TOPDIR            relative path to top of sources
  123.     TagsCmd            command to run tags
  124.     TblCmd            command to run tbl
  125.     TroffCmd        command to run troff to get PostScript
  126.     UNCOMPRESSPATH        command to run uncompress
  127.     UnalignedReferencesAllowed    boolean for unaligned copies ok
  128.     UsrLibDir        directory in which to install libraries
  129.     YaccCmd            command to run yacc
  130.  
  131. Project.tmpl provides defaults for the following variables:
  132.  
  133.     AdmDir            directory containing system log files
  134.     AllocateLocalDefines    -D's to turn on alloca()
  135.     BDFTOSNFFILT        command to run bdftosnf
  136.     BaseExtensionDefines    universal extensions to use
  137.     BinDir            directory in which to install programs
  138.     BuildFontServer        build font server
  139.     BuildFonts        build pcf fonts
  140.     BuildFresco        build Fresco
  141.     BuildIncRoot        relative path to location of headers in build
  142.     BuildIncTop        path from build includes directory to top
  143.     BuildPex        build all PEX-related code
  144.     BuildPexClients        boolean for building PEX clients/demos
  145.     BuildPexExt        build PEX extension
  146.     BuildServer        build X server
  147.     BuildXIE        build X Image Extension
  148.     BuildDIS        build Document Imaging Subset of XIE
  149.     BuildXInputExt        build X Input extension
  150.     BuildXInputLib        build X Input library
  151.     BuildXKB        build X Keyboard Extension?
  152.     ConfigDir        install directory for config files
  153.     ConnectionFlags        -D's for supported transports
  154.     ContribDir        location of user-contributed sources
  155.     DebugLibFS        build libFS_d.a
  156.     DebugLibICE        build libICE_d.a
  157.     DebugLibPex        build libPEX5_d.a
  158.     DebugLibSM        build libSM_d.a
  159.     DebugLibX11        build libX11_d.a
  160.     DebugLibXau        build libXau_d.a
  161.     DebugLibXaw        build libXaw_d.a
  162.     DebugLibXdmcp        build libXdmcp_d.a
  163.     DebugLibXext        build libXext_d.a
  164.     DebugLibXi        build libXi_d.a
  165.     DebugLibXie        build libXie_d.a
  166.     DebugLibXmu        build libXmu_d.a
  167.     DebugLibXt        build libXt_d.a
  168.     DebugLibXtst        build libXtst_d.a
  169.     DebugOldX        build liboldX_d.a
  170.     DefaultFSConfigFile    default font server config file
  171.     DefaultFontPath        default server font path
  172.     DefaultRGBDatabase    default server rgb color database
  173.     DefaultSystemPath    default system xdm PATH environment variable
  174.     DefaultSystemShell    default /bin/sh
  175.     DefaultUserPath        default user xdm PATH environment variable
  176.     DependCmd        command to run makedepend
  177.     DependDir        build directory containing makedepend program
  178.     ExtensionDefines    -D's for universal extensions
  179.     ExtensionOSDefines    -D's for additional extensions
  180.     FontCompilerFlags    flags for bdftosnf
  181.     FontDefines        -D's to turn on font options
  182.     FontDir            directory in which to install fonts
  183.     FontFilters        -D's to specify font conversion filters
  184.     FontOSDefines        -D's for which fonts to support
  185.     ForceNormalLib        force building of .a in addition to shared lib
  186.     HasXdmAuth        boolean for using XDM-AUTHORIZATION-1
  187.     InstallAppDefFiles    boolean for installing new app defaults files
  188.     InstallFSConfig        boolean for installing fs config file
  189.     InstallLibManPages    boolean for installing library man pages
  190.     InstallXdmConfig    boolean for installing xdm config files
  191.     InstallXinitConfig    boolean for installing xinit config files
  192.     LibDir            directory in which to install X11 support files
  193.     LibManSuffix        man suffix for library pages
  194.     LibmanDir        directory in which to install library man pages
  195.     LintlibDir        directory in which to install lint libs
  196.     ManDir            directory in which to install program man pages
  197.     ManDirectoryRoot    parent of man directories relative to root
  198.     ManPath            full path of parent directory
  199.     ManSourcePath        common prefix of man page directories
  200.     ManSuffix        man suffix for programs
  201.     NeedDefaultDepLibs    boolean for enabling default DEPLIBS
  202.     NlsDir            directory in which to install nls files
  203.     NormalLibFS        build libFS.a
  204.     NormalLibICE        build libICE.a
  205.     NormalLibPex        build libPEX5.a
  206.     NormalLibPhigs        build libphigs.a
  207.     NormalLibSM        build libSM.a
  208.     NormalLibX11        build libX11.a
  209.     NormalLibXau        build libXau.a
  210.     NormalLibXaw        build libXaw.a
  211.     NormalLibXdmcp        build libXdmcp.a
  212.     NormalLibXext        build libXext.a
  213.     NormalLibXi        build libXi.a
  214.     NormalLibXie        build libXie.a
  215.     NormalLibXmu        build libXmu.a
  216.     NormalLibXt        build libXt.a
  217.     NormalLibXtst        build libXtst.a
  218.     NormalOldX        build liboldX.a
  219.     OsNameDefines        beats me
  220.     PexApiDir        PEX include file location
  221.     PexCCOptions        special options for building PEX library
  222.     PexCDebugFlags        special flags for building PEX library
  223.     PexClientDefines    special -D's for building PEX clients
  224.     PexDipexDefines        special -D's for building PEX di files
  225.     PexPhigsDefines        special -D's for building PEX library
  226.     PexShmIPC        boolean for using shared memory in phigsmon
  227.     PhigsInclude        include directory for phigs clients
  228.     PrimaryScreenResolution    resolution of default server screen
  229.     ProfileLibFS        build libFS_p.a
  230.     ProfileLibICE        build libICE_p.a
  231.     ProfileLibPex        build libPEX5_p.a
  232.     ProfileLibSM        build libSM_p.a
  233.     ProfileLibX11        build libX11_p.a
  234.     ProfileLibXau        build libXau_p.a
  235.     ProfileLibXaw        build libXaw_p.a
  236.     ProfileLibXdmcp        build libXdmcp_p.a
  237.     ProfileLibXext        build libXext_p.a
  238.     ProfileLibXi        build libXi_p.a
  239.     ProfileLibXie        build libXie_p.a
  240.     ProfileLibXmu        build libXmu_p.a
  241.     ProfileLibXt        build libXt_p.a
  242.     ProfileLibXtst        build libXtst_p.a
  243.     ProfileOldX        build liboldX_p.a
  244.     ProjectX        version indicating this is the X Window System
  245.     RemoveTargetProgramByMoving    boolean for rm -f that doesn't
  246.     SHELLPATH        -D for /bin/sh
  247.     ServerDefines        complete -D's for server
  248.     ServerExtraDefines    special -D's for server
  249.     ServerOSDefines        OS -D's for server
  250.     SharedLibFS        boolean for making sharable libFS.so
  251.     SharedLibICE        boolean for making sharable libICE.so
  252.     SharedLibPex        boolean for making sharable libPEX5.so
  253.     SharedLibPhigs        boolean for making sharable libphigs.so
  254.     SharedLibSM        boolean for making sharable libSM.so
  255.     SharedLibX11        boolean for making sharable libX11.so
  256.     SharedLibXau        boolean for making sharable libXau.so
  257.     SharedLibXaw        boolean for making sharable libXaw.so
  258.     SharedLibXdmcp        boolean for making sharable libXdmcp.so
  259.     SharedLibXext        boolean for making sharable libXext.so
  260.     SharedLibXi        boolean for making sharable libXi.so
  261.     SharedLibXie        boolean for making sharable libXie.so
  262.     SharedLibXmu        boolean for making sharable libXmu.so
  263.     SharedLibXt        boolean for making sharable libXt.so
  264.     SharedLibXtst        boolean for making sharable libXtst.so
  265.     SharedOldX        boolean for making sharable liboldX.so
  266.     ShmDefines        MIT-SHM define
  267.     TwmDir            directory in which to install twm config files
  268.     UseCCMakeDepend        boolean for using alternate makedepend script
  269.     UseRgbTxt        use rgb.txt file as is instead of DBM-compiled
  270.     XAppLoadDir        directory in which to install app defaults
  271.     XFileSearchPathBase    base file search path
  272.     XFileSearchPathDefault    default path to search for app defaults files
  273.     XInputDefines        XINPUT define
  274.     XawClientDepLibs    DEPLIBS for clients that use Xaw
  275.     XawClientLibs        LOCAL_LIBRARIES for clients that use Xaw
  276.     XdmConfigurationSubdirectory    name of default xdm configuration
  277.     XdmDir            directory in which to install xdm files
  278.     XdmServersType        type of xdm Xservers file to install
  279.     XinitDir        directory in which to install xinit files
  280.     XmanLocalSearchPath    non-standard path for man pages
  281.     XtErrorPrefix        leading text in XtError() msg; eg. 'X Toolkit '
  282.     XtWarningPrefix        leading text in XtWarning()msg, same as above
  283.     ZBDFTOSNFFILT        -D to run uncompress and bdftosnf
  284.  
  285.  
  286. Library.tmpl provides defaults for the following variables:
  287.  
  288.     AvoidNullMakeCommand    for makes that spout about $(_NULLCMD_)
  289.     LibraryCCOptions    special C compiler options for libraries
  290.     LibraryCDebugFlags    library debug/optimize flags to override defs
  291.     LibraryCcCmd        command to run C compiler in libraries
  292.     LibraryCplusplusOptions special C++ options for libraries
  293.     LibraryCplusplusDebugFlags  library debug/optimize flags for C++
  294.     LibraryCplusplusCmd    command to run C++ compiler in libraries
  295.     LibraryDefines        -D's for libraries
  296.     SeparateSharedCompile    shared and unshared libs use same binaries?
  297.  
  298.  
  299. Server.tmpl provides defaults for the following variables:
  300.  
  301.     ServerCCOptions        server C compiler options to override defaults
  302.     ServerCcCmd        command to run C compiler in server
  303.     ServerCDebugFlags    server debug/opt compiler flags
  304.     ServerDefines        server standard -D's
  305.     InstallServerSetUID    does this system need X server suid to root?
  306.  
  307.  
  308. Threads.tmpl provides defaults for the following variables:
  309.  
  310.     LocalThreads        whether to enable multi-threading support
  311.     LocalThreadsDefines    -D flags needed in this directory
  312.  
  313.  
  314. An <os>Lib.rules file provides defaults for the following variables:
  315.  
  316.     HasSharedLibraries    boolean for using shared libraries
  317.     SharedDataSeparation    boolean indicating separate data/code
  318.     SharedCodeDef        -D's for compiling shared library files
  319.     SharedLibraryDef    -D's for defining which kind of shared lib
  320.     ShLibIncludeFile    location of the <os>Lib.tmpl file
  321.     SharedLibraryLoadFlags    loader flags when making the library
  322.     PositionIndependentCFlags         PIC compiler flags for C
  323.     PositionIndependentCplusplusFlags    PIC compiler flags for C++
  324.  
  325.       Note: PositionIndependentCplusplusFlags is only required if the 
  326.       C and C++ compilers use different flags to build PIC code.  The
  327.       default configuration will try to use PositionIndependentCFlags 
  328.       for both C and C++ compiles.
  329.  
  330. An <os>Lib.tmpl file provides defaults for the following variables:
  331.  
  332.     SharedFSReqs        required libs for libFS.so
  333.     SharedFSRev        version number for libFS.so
  334.     SharedICEReqs        required libs for libICE.so
  335.     SharedICERev        version number for libICE.so
  336.     SharedOldXReqs        required libs for liboldX.so
  337.     SharedOldXRev        version number for liboldX.so
  338.     SharedPexReqs        required libs for libPEX5.so
  339.     SharedPexRev        version number for libPEX5.so
  340.     SharedSMReqs        required libs for libSM.so
  341.     SharedSMRev        version number for libSM.so
  342.     SharedX11Reqs        required libs for libX11.so
  343.     SharedX11Rev        version number for libX11.so
  344.     SharedXauReqs        required libs for libXau.so
  345.     SharedXauRev        version number for libXau.so
  346.     SharedXawReqs        required libs for libXaw.so
  347.     SharedXawRev        version number for libXaw.so
  348.     SharedXdmcpReqs        required libs for libXdmcp.so
  349.     SharedXdmcpRev        version number for libXdmcp.so
  350.     SharedXextReqs        required libs for libXext.so
  351.     SharedXextRev        version number for libXext.so
  352.     SharedXiReqs        required libs for libXi.so
  353.     SharedXiRev        version number for libXi.so
  354.     SharedXieReqs        required libs for libXie.so
  355.     SharedXieRev        version number for libXie.so
  356.     SharedXmuReqs        required libs for libXmu.so
  357.     SharedXmuRev        version number for libXmu.so
  358.     SharedXtReqs        required libs for libXt.so
  359.     SharedXtRev        version number for libXt.so
  360.     SharedXtstReqs        required libs for libXtst.so
  361.     SharedXtstRev        version number for libXtst.so
  362.  
  363. The following variables are used by some part of the tree:
  364.  
  365.     AckToolset        programs/Xserver/hw/xfree86
  366.     BuildChooser        build the xdm chooser program?
  367.     SharedLibXdmGreet    use xdm shared dynamic greeter library?
  368.     LatexCmd        command to run LaTeX on a document
  369.     DvipsCmd        command to turn .dvi file into PostScript
  370.     MotifBC            using Motif 1.1.1, 1.1.2, or 1.1.3?
  371.     GetValuesBC        compat GetValues behavior for broken apps?
  372.     NeedBerklib        application needs libXbsd?
  373.     SvgaConfig        default SVGA configuration
  374.     HasGetReturnAddress    util/memleak
  375.     HasShadowPasswd        system has getspnam() function
  376.